import { APITable } from "../../../components/APITable";

# `@stackflow/plugin-map-initial-activity`

주어진 URL을 사용하여 초기 액티비티를 매핑하는 데 사용되는 플러그인이에요.

## 설치

```bash npm2yarn copy
npm install @stackflow/plugin-map-initial-activity
```

## 사용법

```ts showLineNumbers filename="stackflow.ts" copy
import { stackflow } from "@stackflow/react";
import { mapInitialActivityPlugin } from "@stackflow/plugin-map-initial-activity";

const { Stack, useFlow } = stackflow({
  activities: {
    // ...
  },
  plugins: [
    mapInitialActivityPlugin({
      mapper(url) {
        // implement mapping logic using url parameter

        return {
          activityName: "...",
          activityParams: {},
        };
      },
    }),
  ],
});
```

## 레퍼런스
### 옵션
<APITable>
|         |                                                                       |                                                                                                        |
| ------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| mapper  | `(url: URL) => { activityName: string; activityParams: {}; } \| null` | URL을 받아서 액티비티 이름과 매개변수가 포함된 객체를 반환하거나, 일치하는 것이 없으면 null을 반환하는 함수예요. |
</APITable>